home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / kgraf.arc / KG.DOC < prev    next >
Text File  |  1989-04-01  |  31KB  |  911 lines
  1.   
  2.   
  3.   
  4.   
  5.   
  6.   
  7.   
  8.                           KWIKGRAF MINI-MANUAL
  9.   
  10.            Quick Graphics for IBM PC and Compatible Computers
  11.                            by Alan C. Elliott
  12.   
  13.                                 TexaSoft
  14.                               P.O. Box 1169
  15.                          Cedar Hill, Texas 75104
  16.                               214-291-2115
  17.                         April, 1989  Version 1.00
  18.                   (C)Copyright 1983-89 Alan C. Elliott
  19.   
  20.   
  21.   
  22.   
  23.   
  24.   
  25.   ALL RIGHTS RESERVED
  26.   
  27.   No patent liability is assumed with respect to the use of the 
  28.   information contained herein. While every precaution has been taken 
  29.   in the preparation of this publication, the publisher assumes no 
  30.   responsibility for errors or omissions. Neither is any liability 
  31.   assumed for damages resulting from the use of the information 
  32.   herein. 
  33.   
  34.   MANUAL ON DISK:This mini-manual contains brief explanations 
  35.   concerning the functions of KWIKGRAF. Also reference the KGTUTOR 
  36.   tutorial. This is a shareware product. If you use this product, 
  37.   please fill out the order form, and become a registered user. You 
  38.   will receive the latest version, a copy of the full bound manual and 
  39.   you will be placed on the mailing list for the newsletter and for 
  40.   information on updates. Thanks. 
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                         1
  60.           
  61.           KWIKGRAF Version 1.00   - Please become a registered user.
  62.           
  63.  
  64.           ORDER FORM FOR KWIKGRAF                       SN:ORI0489
  65.           ========================================================
  66.           KWIKGRAF complete package, bound manual,
  67.           registration, diskette ($35) x ________=     $____________
  68.  
  69.           Preorder next update of KWIKGRAF, full package,
  70.           including manual   $20   x ___________  =    $____________
  71.  
  72.           KWIKSTAT - Statistical Analysis Package
  73.           registration & diskettes ($35) x ________=   $____________
  74.  
  75.           Texas Residents add 7%  sales tax            $____________
  76.  
  77.           Add $4.00 Normal Postage and Handling
  78.           or add $8 for P.O., COD or RUSH Handling
  79.           or add $10 for Overseas Air Mail             $____________
  80.  
  81.           TOTAL ENCLOSED                               $
  82.                                                         ============
  83.           ------------------------------------------------------------
  84.           Payment method:check one
  85.           _____ Check or M.O.         _____ Credit Card (MC or VISA)
  86.  
  87.           Check one: _____ 5 1/4 inch diskette  _____ 3.5 inch diskette
  88.           ------------------------------------------------------------
  89.           IF CREDIT CARD:
  90.           
  91.           Name on Card:_____________________________________________
  92.           
  93.           Type Card is __________________  Exp Date is:_____________
  94.           
  95.           Card Number is:___________________________________________
  96.           
  97.           Authorized Signature:_____________________________________
  98.           -----------------------------------------------------------
  99.           
  100.           Mail order to:____________________________________________
  101.           
  102.           Address:__________________________________________________
  103.           
  104.           City:___________________ St_______ ZIP ___________________
  105.           
  106.           Phone (    )______________________________________________
  107.           -----------------------------------------------------------
  108.           Please mail to:TexaSoft, P.O. Box 1169, Cedar Hill, TX 75104
  109.           Phone Orders call 214-291-2115, have MC or VISA ready.
  110.           
  111.                                   ORDER TODAY!
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                         2
  119.           
  120.           KWIKGRAF Version 1.00   - Please become a registered user.
  121.           
  122.   
  123.   INSTALLING KWIKGRAF 
  124.   
  125.   KWIKGRAF is distributed on a 5 1/4 inch or 3.5 inch diskette containing the 
  126.   KWIKGRAF programs and supporting files. 
  127.   
  128.    REQUIREMENTS:
  129.    1. An IBM PC, AT, PS/2 or compatible computer.
  130.    2. DOS 2.0 or higher.
  131.    3. At least 320K of memory.
  132.    4. A graphics, CGA, EGA, VGA or Hercules graphics type monitor
  133.   
  134.   
  135.   ----- INSTALLING KWIKGRAF ----- 
  136.   
  137.   STEP 1: Place KWIKGRAF disk in drive A:. Make disk A: the default drive, by 
  138.   entering: 
  139.   
  140.   C>A: 
  141.   
  142.   Enter: 
  143.   
  144.   A>KWIKLOAD C: 
  145.   
  146.   All necessary files will be loaded onto directory C:\KWIKGRAF. 
  147.   
  148.   STEP 2: To print a graphics plot to the printer, the DOS file GRAPHICS.COM 
  149.   must be loaded. (Hercules graphics -- Check information in the appendix) The 
  150.   command GRAPHICS is in the KG.BAT file used to begin KWIKGRAF. In order for 
  151.   DOS to know where to find the GRAPHICS.COM command, you must place a PATH 
  152.   command in your AUTOEXEC.BAT file. For example: 
  153.   
  154.   PATH C:\;C:\DOS 
  155.   
  156.   The PATH is activated at boot time. The GRAPHICS program is activated when 
  157.   you enter the KG command. 
  158.   
  159.   MONITOR AND PATH SETUP 
  160.   
  161.   The FIRST time you use KWIKGRAF, you need to tell it what kind of monitor 
  162.   you are using. From the C:\KWIKSTAT directory, enter the command 
  163.   
  164.   C>KGSETUP 
  165.   
  166.   This will place you in the KWIKUTIL program, in the setup procedure. Answer 
  167.   questions about path and monitor, and save it to disk. 
  168.   
  169.   For example, if your data is stored in the subdirectory C:\KWIKGRAF, enter 
  170.   that path. If your data is stored on the B: drive, you would enter B:\ for 
  171.   your path. Select the monitor type you are using. 
  172.   
  173.  
  174.  
  175.  
  176.  
  177.                                         3
  178.           
  179.           KWIKGRAF Version 1.00   - Please become a registered user.
  180.           
  181.   INSTRUCTIONS FOR OPERATION 
  182.   
  183.   From the prompt "C>", change into the KWIKGRAF directory using the command: 
  184.   
  185.   C>CD \KWIKGRAF 
  186.   
  187.   To begin KWIKGRAF, enter the command: 
  188.   
  189.   C>KG 
  190.   
  191.   LATENEWS.DOC 
  192.   
  193.   Print the file LATENEWS.DOC to get the latest information on KWIKGRAF. 
  194.   
  195.   ----- A KWIK TUTORIAL ----- 
  196.   
  197.   This short tutorial will give you a feeling for how to use KWIKGRAF. It will 
  198.   assume you are using KWIKGRAF on a hard disk. Begin KWIKGRAF with the KG 
  199.   command. Notice the three part menu. 
  200.   
  201.   Items lettered A to G are procedures of THIS module.  Items numbered 1 to 3 
  202.   are module selections. In the other modules (KWIKDATA and KWIKUTIL), the 
  203.   lettered options will be different. Press Esc to end the program. 
  204.   
  205.   THE HELP SCREEN 
  206.   
  207.   To examine the HELP menu, press the F1 function key. The HELP menu lists 
  208.   major topics, and the screen number. To look at a particular topic, enter 
  209.   the screen number you desire. 
  210.   
  211.   EXAMPLE GRAPHS 
  212.   
  213.   From the main KWIKGRAF menu, press a G to select the option "Run a KWIKGRAF 
  214.   command file." 
  215.   
  216.   The name of all ".KG" files will appear in a directory listing. Enter the 
  217.   name KGTUTOR, and press Enter. 
  218.   
  219.   KWIKGRAF will lead you through a series of graphs, showing you examples of 
  220.   the kinds of graphs you can create. After you have reached the end of this 
  221.   command file, you will return to the main menu. 
  222.   
  223.   To print a graph, press Shift-PrtScr (or Printscreen, depending on the kind 
  224.   of keyboard you have). Before you print a screen, wait for a few seconds for 
  225.   the message "Press Esc ..." at the bottom of the screen to disappear. 
  226.   
  227.   
  228.   CREATE A GRAPH FROM DOS 
  229.   
  230.   As an example, to execute a graph from DOS, enter the following command at 
  231.   the DOS prompt: 
  232.   
  233.   KWIKGRAF DATA=EXAMPLE GRAPH=PICTO X=STATUS IMG=PERSON 
  234.   
  235.   This illustrates that you can use KWIKGRAF both in menu mode and in DOS 
  236.                                         4
  237.           
  238.           KWIKGRAF Version 1.00   - Please become a registered user.
  239.           
  240.   mode. You can also draw a graph directly from dBASE III, as you will see 
  241.   later. 
  242.   
  243.   WHAT TO DO WHEN SOMETHING GOES WRONG 
  244.   
  245.   If something goes wrong, check the manual, and check your work. If you 
  246.   cannot resolve the problem, fill out the BUG REPORT in the appendix. If you 
  247.   have a suggestion for how to improve KWIKGRAF, send in the USER'S BALLOT. 
  248.   Thanks. 
  249.   
  250.   ----- KWIKGRAF DATA MODULE ----- 
  251.   
  252.   The KWIKGRAF DATA module is used to enter and manage your data. For most 
  253.   procedures, KWIKGRAF requires that you have data in a database before it can 
  254.   be used. 
  255.   
  256.   A KWIKGRAF database uses the same format as a dBASE III file. Therefore data 
  257.   already stored in a dBASE III file may be read directly into KWIKGRAF. 
  258.   
  259.   ----- THE DATA MODULE MENU ----- 
  260.   
  261.   The menu for the data module lists several options: 
  262.   
  263.   A) CREATE A NEW DATABASE 
  264.   
  265.   When you choose CREATE, the program will ask you to specify a name for the 
  266.   database. The name may be up to 8 characters in length, DO NOT include an 
  267.   extension to the name. 
  268.   
  269.   KWIKGRAF will display highlighted areas to enter Name, Type, Width, and 
  270.   number of Decimal places for each field in the database structure, as 
  271.   illustrated below: 
  272.   
  273.    Field name      Type           Width   Dec
  274.   ============================================
  275.   
  276.   1 __________     NUMERIC        ____     ___
  277.   
  278.        |             |             |        |
  279.      enter field    choose      specify   specify
  280.      name here      field       width     # of decimals
  281.                     type                  for numeric fields
  282.    
  283.   
  284.   When you begin CREATE, the cursor will be in the FIELD NAME area. Enter a 
  285.   name, and press the ENTER key. The name you choose will be displayed in all 
  286.   capital letters, and the cursor will move to the next area, TYPE. 
  287.   
  288.   In the TYPE area, type the first character of the desired type, (N, C) for 
  289.   Numeric or Character. 
  290.   
  291.   WIDTH is the number of characters reserved for the entry. Decimal is the 
  292.   number of decimal places (only relevant for numbers). Note that the number 
  293.   of decimal places must be at least one less than the width. For example, if 
  294.   a number has the format ###.##, the width is 6 (count the decimal point), 
  295.                                         5
  296.           
  297.           KWIKGRAF Version 1.00   - Please become a registered user.
  298.           
  299.   and the number of decimal places is 2. 
  300.   
  301.   To end the creation process, type Control-END (^END). As long as you have 
  302.   not ended the procedure, you may use the cursor keys to back up, and make 
  303.   any corrections. 
  304.   
  305.   If you mess up, end CREATE with Esc and begin again. If you want to enter 
  306.   data from the keyboard, answer "Y" to the question "ENTER DATA FROM KEYBOARD 
  307.   NOW (Y/N)" 
  308.   
  309.   B) ENTER DATA 
  310.   
  311.   When you choose this option, you will be prompted to select data entry from 
  312.   the keyboard or from a file 
  313.   
  314.        KEYBOARD DATA ENTRY 
  315.   
  316.   If you are entering data from the keyboard, an entry screen will appear, and 
  317.   you may begin entry. Enter data in the same way the field descriptions were 
  318.   entered. To end keyboard entry, press ^End. 
  319.   
  320.        ENTER DATA FROM A FILE 
  321.   
  322.   You must have first created a database so that the width of each field 
  323.   corresponds to the width of the field in the ASCII data file. The data will 
  324.   be entered into the database, and a count of the records will be displayed. 
  325.   Use the KWIKLOOK procedure to verify that the data has been entered 
  326.   correctly. If the data does not match the fields, refigure the widths, and 
  327.   try again. See section on "Reading Data from a ASCII file." 
  328.   
  329.   C) EDIT DATA 
  330.   
  331.   If you need to change data, use the EDIT option. In the EDIT mode, use the 
  332.   PgUp and PgDn keys to move to records before or after the one you are 
  333.   currently editing. 
  334.   
  335.   In EDIT mode, you may mark records for deletion. This is done by typing a ^U 
  336.   (CTRL-U) while you are editing a specific record. A **DEL** will appear on 
  337.   the screen of a deleted record. To permanently get rid of records, use the 
  338.   "pack" procedure. 
  339.   
  340.   D) PACK THE DATABASE 
  341.   
  342.   Use this procedure to permanently get rid of records marked ***DEL*** in 
  343.   Edit. 
  344.   
  345.   E) DISPLAY STRUCTURE 
  346.   
  347.   Displays the structure of a database, as you created it in dBASE or in 
  348.   CREATE. 
  349.   
  350.  
  351.  
  352.  
  353.  
  354.                                         6
  355.           
  356.           KWIKGRAF Version 1.00   - Please become a registered user.
  357.           
  358.   F) MISSING VALUES 
  359.   
  360.   Sometimes data values are lost or cannot be gathered. Code these missing 
  361.   values with an impossible value. For example, missing values for the 
  362.   variable AGE may be -9. When the program is asked to use that field, it will 
  363.   ignore records where AGE is -9. 
  364.   
  365.   If missing values are NOT used, and there is a blank numeric variable in a 
  366.   calculation, it will be treated as a 0 (zero), so it is important to use 
  367.   missing values if your data contains such entries. 
  368.   
  369.   G) TRANSFORMATION 
  370.   
  371.   Create a new variable in a database with the transformation procedure. For 
  372.   example, if you wanted a new variable to be the ratio of WEIGHT to HEIGHT, 
  373.   you could name a new variable RATIO, and use the expression WEIGHT/HEIGHT to 
  374.   create the new variable. To use TRANSFORMATION, you will need to define 
  375.   
  376.    1. A name for the new field
  377.    2. A width for the new field
  378.    3. The number of decimals, if any.
  379.    4. Missing value. If none is selected, it is assumed to be 0.
  380.   
  381.   CAREFUL ATTENTION must be paid to the definition to assure that the 
  382.   calculated numbers fit into the field width. If an illegal calculation is 
  383.   attempted, such as a division by 0, or if the calculation includes a missing 
  384.   value, the result will be missing. 
  385.   
  386.   OPERATIONS ALLOWED IN A TRANSFORMATION 
  387.   
  388.    Mathematical operators:
  389.   
  390.   Add          +       Divide            /       Exponentation     ^
  391.   Subtract     -       Multiply          *
  392.   
  393.   MATHEMATICAL FUNCTIONS
  394.   
  395.   NAME  Meaning        Example      NAME  Meaning         Example
  396.   ------------------------------    --------------------------------------
  397.   ABS   Absolute value ABS(SCORE)   MAX   Maximum of list MAX(1,T2,3)
  398.   ACOS  Arc Cosine     ACOS(SCORE)  MIN   Minimum of list MIN(1,T2,T3)
  399.   ASIN  Arc Sine       ASIN(SCORE)  MOD   MOD of number   MOD(9,2), 9 mod 2
  400.   ATAN  Arc Tangent    ATAN(SCORE)  PI    PI              3.14159265358979
  401.   ATAN2 Arc Tanget y/x ATAN2(y,x)   RAND  Random number   between 0 and 1
  402.   CSC   Cosecant       CSC(SCORE)   RECNO Record number   record number
  403.   COS   Cosine         COS(SCORE)   ROUND Rounds number ROUND(1.236,2)=1.24
  404.   COT   Cotangent      COT(SCORE)   SEC   Secant          SEC(SCORE)
  405.   EXP   Exponentation  EXP(SCORE)   SIN   Sine            SIN(SCORE)
  406.   INT   Integer        INT(SCORE)   SQRT  Square root     SQRT(SCORE)
  407.   LN    Natural Log    LN(SCORE)    SUM   Sum of list     SUM(1,2,3) = 6
  408.   LOG   Log base 10    LOG(SCORE)   TAN   Tangent         TAN(SCORE)
  409.   
  410.  
  411.  
  412.  
  413.                                         7
  414.           
  415.           KWIKGRAF Version 1.00   - Please become a registered user.
  416.           
  417.   Here are a few examples of expressions, where the new variable is called 
  418.   NEW, and numerical variables in the database include AGE, WEIGHT, HEIGHT, 
  419.   and SCORE 
  420.   
  421.    NEW = AGE/HEIGHT
  422.    NEW = SUM(AGE,WEIGHT,HEIGHT,SCORE)
  423.    NEW = SCORE * RAND
  424.    NEW = PI * (SCORE ^ 2)
  425.   
  426.   H) SUBSET DATABASE 
  427.   
  428.   This allows you to create a new database, using a conditional critera to 
  429.   output information from the old database to a new one. 
  430.   
  431.   Suppose you have a database with a field GROUP with values 1, 2, 3, 4 and 5. 
  432.   You want to create a database that does NOT include Group 5. First specify 
  433.   the name of the new database, for example, "NO5". Next, you are asked for 
  434.   the field name to be used in the selection criteria. In this case, you would 
  435.   choose the field named GROUP. Now enter the selection criteria as as a 
  436.   numerical expression. The conditional operators you may use are: 
  437.   
  438.       +  - / * ^ and the logical operator .NOT. 
  439.   
  440.   The program will prompt you with 
  441.   
  442.   SELECT IF GROUP 
  443.   
  444.   and you must finish the selection criteria.  For example: 
  445.   
  446.   SELECT IF GROUP .NOT. = 5 
  447.   
  448.   (Select those records for which the variable GROUP is not equal to 5) 
  449.   
  450.   Other selections might be: 
  451.   
  452.   SELECT IF GROUP < 4
  453.   SELECT IF GROUP <= LOG(TIME)   . . . etc . . .
  454.   
  455.   I) KWIKLOOK 
  456.   
  457.   KWIKLOOK produces an on-screen list of the data. 
  458.   
  459.   
  460.   ----- READING DATA FROM ASCII FILES ------ 
  461.   
  462.   KWIKGRAF can read data from other programs that can store data in an ASCII 
  463.   type file. Data must be in the form of column data, like this... 
  464.   
  465.    A 22 3.3              Notice:Group width = 1
  466.    B 33 4.2                     Age width   = 3
  467.    :                            Score width = 4 (and 1 decimal place)
  468.    ETC
  469.   
  470.   First, create the structure of your database in option A. 
  471.   
  472.                                         8
  473.           
  474.           KWIKGRAF Version 1.00   - Please become a registered user.
  475.           
  476.   The field widths MUST match the width of the columns of data on file. If 
  477.   there are spaces between columns of data, make widths wide enough to account 
  478.   for those spaces. 
  479.   
  480.   In this example, define three fields: GROUP, AGE and SCORE as types 
  481.   Character, Numeric and Numeric respectively, and with widths 1, 3, and 4. 
  482.   Specify 1 decimal place for field SCORE. Notice that the widths 3 and 4 
  483.   include one column that is blank, so that the data is specified in a 
  484.   continuous manner. 
  485.   
  486.   If there are columns in the input you want to ignore, just give them a dummy 
  487.   name, and call them character fields. 
  488.   
  489.   Once you have defined the database to match the ASCII input file, choose 
  490.   ENTER DATA from a FILE option. 
  491.   
  492.   
  493.   
  494.   ----- KWIKGRAF MODULE ----- 
  495.   
  496.   The KWIKGRAF module may be run in menu mode, from DOS, from dBASE III, or 
  497.   from any program that allows you to run a temporary program. 
  498.   
  499.   THE KWIKGRAF COMMAND LINE 
  500.   
  501.   The KWIKGRAF command line specifies what database to use, which graph to 
  502.   draw, which variable in the database to use, a title, and other information 
  503.   specific to the graph being displayed. A command line looks like this: 
  504.   
  505.   DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="THIS IS MY TITLE" 
  506.   
  507.   Important points: 
  508.   
  509.       1. No blanks between the key word, the equal sign and
  510.          the specification (i.e. DATA=EXAMPLE)
  511.       2. Case does not matter.
  512.       3. Titles MUST be enclosed in double quotes
  513.   
  514.   In the above example, the database is specified by the DATA keyword, and the 
  515.   database name is EXAMPLE. The GRAPH keyword specifies a PIE chart. The X 
  516.   variable is has the field name STATUS, and the TITLE is "THIS IS MY TITLE". 
  517.   
  518.   Required KWIKGRAF keywords for drawing a graph: 
  519.   
  520.       DATA=    Specified database name
  521.   
  522.       GRAPH=   Specifies graph type. This can be PIE
  523.                HISTOGRAM, PICTOGRAPH, SCATTERPLOT,
  524.                TIMEPLOT or 3-D HISTOGRAM.  These can be
  525.                abbreviated to PIE, HISTO, PICTO, SCAT,
  526.                TIME and 3-D.
  527.   
  528.       X=       Specifies field name of variable to use
  529.   
  530.   If two variables are required, as in SCAT and 3-D, then a required keyword 
  531.                                         9
  532.           
  533.           KWIKGRAF Version 1.00   - Please become a registered user.
  534.           
  535.   is: 
  536.   
  537.       Y=       Specifies second field name
  538.   
  539.   PIE CHARTS 
  540.   
  541.   A pie chart may be created from the "B" menu option, or from a command line. 
  542.   Specifics of the command line are: 
  543.   
  544.   Required Keywords: DATA=databasename
  545.                      GRAPH=PIE
  546.                      X=fieldname
  547.   
  548.   Optional Keywords: TITLE="title in quotes"
  549.   
  550.   For example:
  551.   
  552.   KWIKGRAF DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="Pie Chart on Status"
  553.   
  554.   PICTOGRAMS
  555.   
  556.   Pictographs may be created from the "B" menu option, or
  557.   from a command line. Specifics of the command line are:
  558.   
  559.   Required Keywords: DATA=databasename
  560.                      GRAPH=PICTO
  561.                      X=fieldname
  562.                      IMG=imagefile
  563.   
  564.   Optional Keywords: TITLE="title in quotes"
  565.   
  566.   Several image files are included on disk, including BAR1.IMG, which is a
  567.   small bar, and BAR2.IMG, which is a large bar.  Images are created in the
  568.   utility module.
  569.   
  570.   For example:
  571.                                                       
  572.   KWIKGRAF DATA=EXAMPLE GRAPH=PICTO X=STATUS IMG=BAR1 TITLE="Status"
  573.   
  574.   3-D BAR CHART SUMMARY
  575.   
  576.   3-D Bar Charts may be created from the "C" menu option, or from a command 
  577.   line. Specifics of the command line are: 
  578.   
  579.   Required Keywords: DATA=databasename
  580.                      GRAPH=3-D
  581.                      X=fieldname
  582.                      Y=fieldname
  583.                                                                             
  584.   Optional Keywords: TITLE="title in quotes"
  585.   
  586.   For example:
  587.                                                                             
  588.   KWIKGRAF DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"
  589.   
  590.                                         10
  591.           
  592.           KWIKGRAF Version 1.00   - Please become a registered user.
  593.           
  594.   
  595.   HISTOGRAMS
  596.   
  597.   Histograms may be created from the "D" menu option, or from a command line. 
  598.   Specifics of the command line are: 
  599.   
  600.   Required Keywords: DATA=databasename
  601.                      GRAPH=HISTO
  602.                      X=fieldname (must be numeric)
  603.   
  604.   Optional Keywords: TITLE="title in quotes"
  605.                                                       
  606.   For example
  607.   
  608.   KWIKGRAF DATA=EXAMPLE GRAPH=HISTO X=AGE TITLE="Histogram on Age"
  609.   
  610.   
  611.   SCATTERPLOTS
  612.   
  613.   Scatterplots may be created from the "E" menu option, or from a command 
  614.   line. Specifics of the command line are: 
  615.   
  616.   Required Keywords: DATA=databasename
  617.                      GRAPH=SCAT
  618.                      X=fieldname (must be numeric)
  619.                      Y=fieldname (must be numeric)
  620.                                                                             
  621.   Optional Keywords: TITLE="title in quotes"
  622.                                                                             
  623.   For example:
  624.                                                                             
  625.   KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
  626.   
  627.   TIME SERIES PLOTS
  628.   
  629.   Time Series plots may be created from the "F" menu option, or from a command
  630.   line. Specifics of the command line are:
  631.   
  632.   Required Keywords: DATA=databasename
  633.                      GRAPH=TIME
  634.                      X=fieldname (must be numeric)
  635.   
  636.   Optional Keywords: TITLE="title in quotes"
  637.   
  638.   For example:
  639.                                                                            
  640.   KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"
  641.   
  642.   RUNNING KWIKGRAF from dBASE III
  643.   
  644.   From within dBASE III, either from command mode, or in a program, you can 
  645.   cause a KWIKGRAF graph to be produced by using the RUN command. For example, 
  646.   to produce the last TIME SERIES PLOT, you would have used the command: 
  647.   
  648.    .RUN KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1" 
  649.                                         11
  650.           
  651.           KWIKGRAF Version 1.00   - Please become a registered user.
  652.           
  653.   
  654.   For this to work, the KWIKGRAF program needs to be in the same subdirectory 
  655.   as dBASE III. Otherwise, you need to place the path name before the KWIKGRAF 
  656.   command. 
  657.   
  658.   KWIKGRAF COMMAND FILES 
  659.   
  660.   A KWIKGRAF command file uses the same syntax as if you had given the command 
  661.   from DOS. Here are some examples: 
  662.   
  663.   DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
  664.   DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"
  665.   
  666.   If your command is too long for a line, your can place a "+" at the end of 
  667.   the line, which will make KWIKGRAF continue to read it to the next line. For 
  668.   example: 
  669.   
  670.   DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 +
  671.   TITLE="Time1 by Time2"
  672.   
  673.   To cause text, such as what you are reading to be displayed, place the 
  674.   command @DISPLAY on a line, followed by all of the lines to display, and end 
  675.   the display with the command @END. If you place the keyword BORDER on the 
  676.   line with @DISPLAY, a border will appear around the text. To run a command 
  677.   file, enter the following command from DOS. 
  678.   
  679.   KWIKGRAF FILE=commandfile 
  680.   
  681.   Command files should have a .KG extension. 
  682.   
  683.   You may also run a command file from KWIKGRAF menu selection "G". 
  684.   
  685.   The KWIKGRAF Menu 
  686.   
  687.   If you enter the KWIKGRAF command from DOS with no other keywords, you will 
  688.   be in "menu" mode, where you can interactively create graphs. 
  689.   
  690.   There are a few more options you can choose from the menu mode than from the 
  691.   command mode, such as specifying certain minimums and maximums for graphs. 
  692.   You can also run two other KWIKGRAF programs, KWIKDATA and KWIKUTIL 
  693.   
  694.   KWIKDATA - create a DATABASE file, enter data, manipulate data. 
  695.   
  696.   KWIKUTIL - Create an IMAGE, set colors and default disk, output reports. 
  697.   
  698.   
  699.   
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.                                         12
  709.           
  710.           KWIKGRAF Version 1.00   - Please become a registered user.
  711.           
  712.   ----- KWIKUTIL - KWIKGRAF UTILITIES - OUTPUT, SETUP, IMAGE ----- 
  713.   
  714.   The KWIKGRAF UTILITY module allows you to output data from the 
  715.   dBASE/KWIKGRAF database and to create images for use in pictographs. Items 
  716.   on the menu are: 
  717.   
  718.   A - CHOOSE ANOTHER DATABASE 
  719.   
  720.   B - OUTPUT SDF FILE - Output the data into a standard ASCII TEXT file. (SDF 
  721.   - Standard Data Format). 
  722.   
  723.   C - SET UP - This option allows you to tell KWIKGRAF the kind of monitor you 
  724.   are using, where you data is stored (PATH), and choose colors. This MUST be 
  725.   performed if you are using a Hercules type monitor. 
  726.   
  727.   D - IMAGE ROUTINE - The image program allows you to create new IMG files or 
  728.   edit images already created. You will be asked if you want to create a NEW 
  729.   image, or to edit an OLD image. If you choose to enter a NEW image, you will 
  730.   be asked the pixel size. Maximum size for an image is 40 pixels (dots) wide 
  731.   and 30 pixels high. IMAGE IS NOT SUPPORTED ON HERCULES MONITORS. 
  732.   
  733.   In the image editor, move the cursor around the grid, and select to fill a 
  734.   dot by pressing the numbers 1, 2 or 3. Even though the images in the IMAGE 
  735.   program are in color, the Pictograph will produce only black and white 
  736.   images. To unfill a dot, place the cursor at the dot and press the space 
  737.   bar. Once you have created or edited an image, choose the (S)ave option to 
  738.   save the file. Do not use an extension when giving a name, the extension IMG 
  739.   is always used. 
  740.   
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                         13
  768.           
  769.           KWIKGRAF Version 1.00   - Please become a registered user.
  770.           
  771.                              ----- APPENDIX I -----
  772.   
  773.    SOME COMMON ERROR CODES
  774.   
  775.   24 - Device Timeout - Your printer may be off or disconnected.
  776.   25 - Printer has malfunctioned
  777.   27 - Printer is out of paper
  778.   61 - Disk Full
  779.   67 - Too many files on one diskette
  780.   70 - Disk is write protected
  781.   71 - Disk is not ready (Is drive door closed?)
  782.   72 - Disk Media Error (Disk may be bad)
  783.   Others: Check Appendix in IBM or Microsoft BASIC manual
  784.   
  785.                              ----- APPENDIX II -----
  786.   
  787.   BUG REPORT FOR KWIKGRAF: explain in detail the problem that occurred. If 
  788.   possible, send a print out of the results or Print Screen. 
  789.   
  790.   
  791.   
  792.   
  793.   
  794.   
  795.   
  796.   
  797.   
  798.   
  799.   Mail to:TexaSoft, P.O. Box 1169, Cedar Hill, Texas 75104. Thanks. 
  800.   
  801.                             ----- APPENDIX III -----
  802.   
  803.   USER'S BALLOT: Please indicate your preference for improvements in KWIKGRAF. 
  804.   On a scale of 0 to 10: 
  805.   
  806.   0 = Very Low priority for this change
  807.   10 = Very High priority for this change
  808.   
  809.    Vote    Proposed item of change
  810.    ------- -------------------------------------------------------
  811.    ____  Better control for print-out of results.
  812.    ____  Stacked Bar charts
  813.    ____  Add stem and leaf plot
  814.    ____  Multiple lines on the same plot
  815.    ____  More control over options from KWIKGRAF command
  816.    ____  _____________________________________________
  817.    ____  _____________________________________________
  818.    ____  _____________________________________________
  819.   
  820.   Mail to:TexaSoft, P.O. Box 1169, Cedar Hill, Texas 75104.
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                         14
  827.           
  828.           KWIKGRAF Version 1.00   - Please become a registered user.
  829.           
  830.                              ----- APPENDIX V -----
  831.   
  832.   HERCULES MONITORS (MONOCHROME GRAPHICS):
  833.   
  834.   Hercules graphics allow standard monochrome monitors to display graphics. In 
  835.   order for KWIKGRAF to know that you are using a Hercules monitor, you must 
  836.   do the following: 
  837.   
  838.   TO GET GRAPHICS TO PRINT TO THE SCREEN: 
  839.   
  840.   1) Copy or rename the file KGH.BAT to KG.BAT so QBHERC will be invoked 
  841.   before the KWIKGRAF program is begun. 
  842.   
  843.   2) In the KWIKUTIL module, choose the SET-UP option and tell KWIKGRAF that 
  844.   you are using a Hercules monitor. Be sure to choose the save-to-disk option. 
  845.   
  846.   TO GET GRAPHICS TO PRINT TO THE PRINTER: 
  847.   
  848.   3) You must replace the DOS GRAPHICS command with a graphics command that 
  849.   supports Hercules monitors. Some examples are SCRDUMP, SIMCGA and PIZZAZ. If 
  850.   you are using a Laserjet, you will need a graphics command that supports the 
  851.   H-P Laserjet. These programs are available through most shareware dealers, 
  852.   or you can order a disk containing a variety of these printer support 
  853.   programs from TexaSoft for $5.00 - or send us a disk with a prepaid return 
  854.   envelope, and we'll send you the programs free. 
  855.   
  856.   4) Put your replacement for the GRAPHICS command in the file KG.BAT (or 
  857.   KGH.BAT). 
  858.   
  859.   Now, when you enter the KG command, QBHERC and your printer graphics 
  860.   programs will be loaded into memory, and will tell KWIKGRAF how to print 
  861.   graphics to the monitor and the printer. 
  862.   
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                         15
  886.  
  887.  the monitor and the printer. 
  888.   
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.                                         1